Executing version control commands in SNiFF+

The following version control operations are described in this section:

- Checking out a version of a file
- Locking a file version
- Checking in files
- Unlocking a version of a file
- Deleting a version of a file
- Replacing the comments of a file version

Checking out a version of a file
You can check out a version of a file in the Project Editor, the Source Editor, Documentation Editor, the Configuration Manager, or the Diff/Merge tool. Here, we will use the Project Editor.

In the Project Editor, select the file in the File List and choose File > Check Out....
The Check Out dialog appears.

2. To check out the file, enter its version number in the Version field or, if the version is part of a configuration, select the configuration name from the list of available configurations.

   | Note
   | You can check out more than one file at a time by selecting them (by holding down <SHIFT> and clicking on the file names with the left mouse button) and then choosing the File > Check Out... command in the Project Editor.

3. Choose a locking mechanism. See also Locking files during check-out.

   | SCCS Version Control
   | If you want to create a new branch and check in the new file version(s) on this branch, select the New Branch check box. A field appears where you can enter the name of the new branch. Enter the name of the new branch. Note that SNiFF+ automatically prefixes the new branch's name with HEAD_ .

Locking a file version
You can lock a version of a file in the Project Editor, the Source Editor, Documentation Editor, or the Diff/Merge tool. Note that you can only check in files that are locked by you.
To lock a file version:

In the Project Editor, select the file and then choose File > Lock... command.
The Lock dialog appears.

2. Enter the version you want to lock in the Version field or, if the version is part of a configuration, select the configuration name from the list of available configurations.
3. Press Ok.
   You now have a local, writable copy of the file version in your working environment. Your version control tools puts an exclusive lock on this version.

Checking in files
You can check in a version of a file in the Project Editor, the Source Editor, Documentation Editor, or the Diff/Merge tool. Here, we will use the Project Editor.

In the Project Editor, select the file(s) in the File List and then choose File > Check In....
A Check In dialog appears.

2. If you want to create a new branch and check in the new file version(s) on this branch, select the New Branch check box.
   A field appears in which you can enter the name of the new branch.
3. Enter the name of the new branch. Note that SNiFF+ automatically prefixes the new branch's name with

HEAD_ .
Enter a version number or configuration name in the Version field. The new branch starts at this point in each checked-in file's version tree. The checked-in file will be the first version on the new branch.
For the SCCS version control system, you have to create branches in the Check Out dialog.
If you want to check in multiple files using a change set, enter the name of the change set in the Change Set field.
If you want to see whether the checked-in file is different from its latest version, select the Check Difference check box.
Check in the file(s):

- To unlock the file(s) after the check-in, press Ok.
- To retain the lock on the file(s) after the check-in, press Retain Lock.

Unlocking a version of a file
You can unlock a version of a file in the Project Editor, the Source Editor, Documentation Editor, or the Diff/Merge tool. Here, we will use the Project Editor.
To unlock a file version:

In the Project Editor, select the file and then choose File > Unlock....
In the Unlock dialog that appears, enter the version you want to unlock in the Version field and press Ok.
Your version control tool removes your exclusive lock on the file version.

Deleting a version of a file
You can delete a version of a file in the Project Editor or in the Configuration Manager. Here, we will use the Project Editor.
To delete a file version:

In the Project Editor, select the file and then choose File > Delete Version....
In the Delete Version dialog that appears, enter the version you want to delete in the Version field and press Ok.
The version you entered is deleted from the file's version tree. Your version control tool readjusts version numbers in the version tree accordingly.

Replacing the comments of a file version
You can replace the comments of version of a file in the Project Editor or in the Configuration Manager. To do so:

Select the file version in either the Project's Editor History View or the Configuration Manager's File List.
Choose File > Replace Comment....
In the Replace Comment dialog that appears, change the file version's comments and then press the Replace button.